home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / xsubpp.z / xsubpp
Encoding:
Text File  |  1998-10-30  |  3.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XXXXSSSSUUUUBBBBPPPPPPPP((((1111))))                                                            XXXXSSSSUUUUBBBBPPPPPPPP((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      xsubpp - compiler to convert Perl XS code into C code
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      xxxxssssuuuubbbbpppppppp [----vvvv] [----CCCC++++++++] [----eeeexxxxcccceeeepppptttt] [----ssss ppppaaaatttttttteeeerrrrnnnn] [----pppprrrroooottttoooottttyyyyppppeeeessss] [----nnnnoooovvvveeeerrrrssssiiiioooonnnncccchhhheeeecccckkkk]
  13.      [----nnnnoooolllliiiinnnneeeennnnuuuummmmbbbbeeeerrrrssss] [----ttttyyyyppppeeeemmmmaaaapppp ttttyyyyppppeeeemmmmaaaapppp]... file.xs
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _x_s_u_b_p_p will compile XS code into C code by embedding the constructs
  17.      necessary to let C functions manipulate Perl values and creates the glue
  18.      necessary to let Perl access those functions.  The compiler uses typemaps
  19.      to determine how to map C function parameters and variables to Perl
  20.      values.
  21.  
  22.      The compiler will search for typemap files called _t_y_p_e_m_a_p.  It will use
  23.      the following search path to find default typemaps, with the rightmost
  24.      typemap taking precedence.
  25.  
  26.              ../../../typemap:../../typemap:../typemap:typemap
  27.  
  28.  
  29. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  30.      ----CCCC++++++++ Adds ``extern "C"'' to the C code.
  31.  
  32.      ----eeeexxxxcccceeeepppptttt
  33.           Adds exception handling stubs to the C code.
  34.  
  35.      ----ttttyyyyppppeeeemmmmaaaapppp ttttyyyyppppeeeemmmmaaaapppp
  36.           Indicates that a user-supplied typemap should take precedence over
  37.           the default typemaps.  This option may be used multiple times, with
  38.           the last typemap having the highest precedence.
  39.  
  40.      ----vvvv   Prints the _x_s_u_b_p_p version number to standard output, then exits.
  41.  
  42.      ----pppprrrroooottttoooottttyyyyppppeeeessss
  43.           By default _x_s_u_b_p_p will not automatically generate prototype code for
  44.           all xsubs. This flag will enable prototypes.
  45.  
  46.      ----nnnnoooovvvveeeerrrrssssiiiioooonnnncccchhhheeeecccckkkk
  47.           Disables the run time test that determines if the object file
  48.           (derived from the .xs file) and the .pm files have the same version
  49.           number.
  50.  
  51.      ----nnnnoooolllliiiinnnneeeennnnuuuummmmbbbbeeeerrrrssss
  52.           Prevents the inclusion of `#line' directives in the output.
  53.  
  54. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  55.      No environment variables are used.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XXXXSSSSUUUUBBBBPPPPPPPP((((1111))))                                                            XXXXSSSSUUUUBBBBPPPPPPPP((((1111))))
  71.  
  72.  
  73.  
  74. AUTHOR
  75.      Larry Wall
  76.  
  77. MMMMOOOODDDDIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN HHHHIIIISSSSTTTTOOOORRRRYYYY
  78.      See the file _c_h_a_n_g_e_s._p_o_d.
  79.  
  80. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  81.      _p_e_r_l(1), _p_e_r_l_x_s(1), _p_e_r_l_x_s_t_u_t(1)
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.